home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / utils / xpack142.zip / XPACK.DOC < prev    next >
Text File  |  1996-06-08  |  9KB  |  233 lines

  1.  
  2.      XPACK    An EXE/COM/SYS Executable file compressor (public domain)
  3.  
  4.      Copyright (c) 1995-1996 by JauMing Tseng
  5.  
  6.    WHAT IS XPACK?
  7.  
  8.      XPACK is an EXE/COM/SYS Executable file compressor. This program
  9.      compresses most DOS executable files. Compressed programs use
  10.      less disk space because they are much smaller,
  11.      yet they run EXACTLY as before.
  12.  
  13.  
  14.    SYSTEM REQUIREMENTS.
  15.  
  16.      XPACK works on any IBM-compatible machine with 192Kb of free
  17.      DOS memory.
  18.      method 2 & 3 need extra 64Kb, method4 need extra 192Kb for compression
  19.  
  20.      Every file compressed with XPACK can run on any IBM compatible
  21.      system: XT, AT, 80286, 80386, 80486, Pentium or Pentium Pro;
  22.      on Intel and non-Intel.
  23.  
  24.      DOS 2.0 or higher is required.
  25.  
  26.    USING XPACK.
  27.  
  28.      Enter the command:   XPACK [options] filename
  29.  
  30.        where "filename" is the name of the Executable file to be compressed.
  31.        XPACK will only work properly on Executable files, so if you do not
  32.        type a file extension, ".EXE", ".COM" or ".SYS" is assumed.
  33.        The filename can include drive and path specifications
  34.        and wildcards (* or ?).
  35.        The various "options" are explained later.
  36.  
  37.      XPACK will make an Executable file that:
  38.        (a) is smaller than the original, and
  39.        (b) works as before, without any noticeable loss of speed.
  40.  
  41.      The computer may take several seconds to do the compressing. If
  42.      you are impatient you can interrupt the process by pressing the
  43.      ESC key.
  44.  
  45.      Not every .EXE file can be compressed with XPACK.
  46.      (e.g. .EXE with internal overlay packed with option /g)
  47.      That's why this program creates backups. The original FILENAME.EXE file
  48.      is renamed to FILENAME.OLE. If anything goes wrong you can
  49.      restore the original file by entering these 2 commands at
  50.      the DOS prompt:
  51.                       COPY FILENAME.OLE FILENAME.EXE
  52.                       DEL FILENAME.OLE
  53.      (.COM and .SYS files are always packed ok.)
  54.  
  55.    OPTIONS.
  56.  
  57.      Any "options" that you use are typed after "XPACK" and
  58.      before "FILENAME".
  59.  
  60.      Options are all case-insensitive, separated by spaces, and begin
  61.      with either the hyphen ('-') or the slash ('/') character.
  62.  
  63.      Here are the details of the command line options:
  64.  
  65.         -?  This switch invokes option -h
  66.  
  67.         -h  This switch tells XPACK to display a
  68.             Help Screen to the DOS console device.
  69.  
  70.                You can use "XPACK /? > XPACK.HLP" to save it.
  71.  
  72.         -2  This switch tells XPACK to use pack method 2
  73.             3rd compression ratio
  74.             fastest compression
  75.             quickest extraction
  76.  
  77.         -3  This switch tells XPACK to use pack method 3
  78.             2nd best ratio
  79.  
  80.         -4  This switch tells XPACK to use pack method 4 (default)
  81.             best ratio
  82.  
  83.         -x  expand a compressed .COM or .SYS file.
  84.  
  85.         -f  This switch tells XPACK to convert the file even if
  86.             the result is bigger than the original file. (Not many
  87.             users will take advantage of this option!)
  88.  
  89.         -o  This switch tells XPACK to override the default
  90.             generation of FILENAME.OLE backup files. (Use this only
  91.             if you have already determined that XPACK compresses
  92.             the file(s) successfully.)
  93.  
  94.         -g  This tells XPACK to merge an overlay into packed file.
  95.  
  96.              (See note below concerning files that cannot be packed.)
  97.  
  98.                Without the -g option, XPACK does not try to compress
  99.                an .EXE file that contains overlays.
  100.  
  101.              The -g option may not work with every .EXE that contains
  102.              an overlay. It works well with .EXE files compiled from
  103.              text (ASCII) with TURBOTXT (an excellent program that is
  104.              supplied with the registered version of the TURBOBAT
  105.              batch file compiler) and overlay programs compiled by
  106.              TURBO/BORLAND pascal compiler.
  107.  
  108.      EXAMPLES.
  109.      ~~~~~~~~~
  110.        To compress all the .EXE files in the current directory
  111.        just type:
  112.                    XPACK *.EXE
  113.  
  114.        To compress without backup all .EXE files in C:\PROGS,
  115.        type:
  116.               XPACK /O C:\PROGS\*.EXE
  117.  
  118.        To pack all the Executable files using method 2, enter this
  119.        command:
  120.                 XPACK /2 *
  121.  
  122.        To compress BUMF.EXE (made from BUMF.TXT using TURBOTXT),
  123.        enter the command:
  124.                           XPACK -g BUMF
  125.  
  126.  
  127.      FILES THAT CAN'T BE PACKED.
  128.  
  129.        Some files can't be compressed with XPACK.
  130.  
  131.                - Programs that check the CRC of a file
  132.                - Files that store configuration data internally
  133.                - Drivers that can be loaded in a
  134.                    config.sys file (EMM386.EXE)
  135.                - Some files with "overlays" or DOS4GW overlays, etc..
  136.                    Some "overlaid" files can't be compressed because
  137.                    when you compress such a file the overlay offset
  138.                    changes and the compressed program may not find
  139.                    an overlay.
  140.  
  141.      WINDOWS AND OS/2 FILES.
  142.  
  143.        We cannot Pack Windows or OS/2 New .EXEs are because at the
  144.        ends of these files there are resources, which have to be
  145.        located there.  (e.g. the BITMAPs, Dialogue, Boxes,
  146.        Buttons, and Icons)
  147.          These resources are loaded not with the execution
  148.        of the file, but only when needed by Windows or OS/2.
  149.          Windows and OS/2 files are automatically recognized by
  150.        XPACK.
  151.  
  152.      DISTRIBUTING XPACK.
  153.  
  154.        The XPACK utility is protected by copyright, and may be
  155.        distributed only according to the following limitations:
  156.          1) NO price may be charged, other than a fee for copying
  157.             and mailing the disk.
  158.          2) The utility and documentation must be included together,
  159.             in unmodified form. The XPACK.COM, XPACK.DOC and XPACK.BG5
  160.             files must stay together.
  161.  
  162.        XPACK can be freely uploaded to any BBS, online system or
  163.        something similar, and can be freely included on any CD-ROM.
  164.  
  165.        Programs compressed with XPACK may be distributed without
  166.        royalties or licensing.
  167.  
  168.      CREDITS.
  169.  
  170.         Optimized by http://www.xs4all.nl/~feldmann
  171.  
  172.         Revised documentation (XPACK.DOC) by John Kiernan.
  173.         I thank the following people for testing and suggestions:
  174.         Fred Lu, John Kiernan, ChengChang Liu, Harald Feldmann, Jeff Gilchrist,
  175.         Henrik Haftmann, Michal Weis, Peter Hubinsky (Slovak Antivirus Center),
  176.         Cristi Bradiceanu (The DOP), Tomas Hajny, Roeland Louwe Kooijmans,
  177.         Keith Petersen. Thank you!
  178.  
  179.         HOW DOES XPACK WORK?
  180.  
  181.           The XPACK utility works by compressing an
  182.           executable file.  The encoded program is written back to
  183.           disk under the original file name, with a relocating
  184.           decoder attached to the file.
  185.             When the executable file executes, control passes to the
  186.           relocating decoder, which relocates itself (and the
  187.           encoded data) higher in memory. It then decodes the
  188.           program into the same place it would have been loaded if
  189.           it were not encoded. The XPACKed program resets the registers
  190.           and flags to their original forms and starts the program
  191.           just as if there had never been any encoding.
  192.  
  193.             If a "CRC" check failure occurs during decoding .EXE, it will
  194.           display a message: "CRC error" and return the user to DOS.
  195.             XPACK has a security function that prevents the .EXE program
  196.           from running if it has been tampered with or accidentally
  197.           corrupted.  You can be pretty certain that your program will
  198.           come up with all the proper screens without hanging
  199.           due to unwanted modification. Your program's underlying
  200.           data will not be left in the open (to any one with a hex editor
  201.           or disassembler) and your code will be safer from others' eyes.
  202.  
  203.      HELP and SUGGESTED IMPROVEMENTS.
  204.  
  205.          Send them to the author's e-mail
  206.          address:
  207.                   s8203143@simon.pu.edu.tw
  208.      URL:
  209.           http://140.128.9.3/home1/86Ga/s8203143/public_html/xpack.html
  210.  
  211.        The latest version of XPACK can always be found on:
  212.  
  213.            Slovak Antivirus Center: ftp.elf.stuba.sk /pub/pc/pack
  214.  
  215.        or its mirrors:
  216.  
  217.            ftp.vse.cz           /pub/msdos/SAC/pc/pack            (Czech)
  218.            ftp-beer.bke.hu      /vol1/pub/sac/pc/pack             (Hungary)
  219.            ftp.cs.tu-berlin.de  /pub/msdos/mirrors/stuba/pc/pack  (Germany)
  220.            http://192.217.228.45:80/pub/sac/pack.htm              (USA)
  221.  
  222.      DISCLAIMER.
  223.  
  224.        Under no circumstances can I be held responsible for any damage
  225.        caused by files in this or any other package containing programs
  226.        written by me.
  227.  
  228.      All programs mentioned in this documentation are trademarks of their
  229.      respective owners. They are used for identification purposes only.
  230.  
  231.   End of the XPACK documentation file.
  232.  
  233.